Skip to content

docs: README + GUIDE — manifestos & brainstormer workflow#150

Merged
hadamrd merged 1 commit into
trunkfrom
docs/manifestos-readme-guide
May 28, 2026
Merged

docs: README + GUIDE — manifestos & brainstormer workflow#150
hadamrd merged 1 commit into
trunkfrom
docs/manifestos-readme-guide

Conversation

@hadamrd
Copy link
Copy Markdown
Owner

@hadamrd hadamrd commented May 28, 2026

Customer-facing documentation for the manifestos + brainstormer feature. New README section (between Briefs and CLI reference). New GUIDE section 4 with the real Titan brainstormer output as the worked example. Cites PR #147 as the canonical feedback-loop example.

Adds the customer-facing documentation for the manifestos + brainstormer
feature that closed the cosmetic-tickets gap. Real customers consuming
this OSS need to know:

1. The four files they own (.forge/product-vision.md, axes.yaml,
   quality-manifesto.md, testing-manifesto.md).
2. The brainstormer dry-run + --apply workflow.
3. The feedback loop (`forge-loop manifesto suggest --from-pr <N>`)
   where every bug becomes a permanent gate.
4. What the worker + critic see (manifestos injected into briefs;
   sev1 violations block auto-merge).

README: new section "Manifestos & the brainstormer (axis-aligned
tickets)" between Briefs and CLI reference. CLI reference table gains
`brainstorm`, `brainstorm --apply`, `manifesto suggest --from-pr`.

GUIDE: new section 4 "Manifestos: drive what gets built (not just how)"
between "discipline matters" and "the brief is your contract" — with
the real Titan brainstormer output as the worked example. Sections
5-10 renumbered accordingly.

Both docs cite PR #147 as the canonical feedback-loop example: a
stringly-typed event-boundary bug that surfaced after #97/#120/#128
all had the same shape; the fix landed the manifesto rule that the
critic now enforces.
@hadamrd hadamrd merged commit ac6ab6c into trunk May 28, 2026
2 checks passed
@hadamrd hadamrd deleted the docs/manifestos-readme-guide branch May 28, 2026 18:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant